ThruWin Index

Commands

Mode Menu

Setup Menu

Display Menu

Disks Menu

Help Menu - Help - It is what you are seeing now

How to use

Bring up/Hide window program feature

DOS run

Known bugs

The Index contains a list of all Help topics available for the ThruWin program. For information on how to use Help, press F1 or choose Using Help from the Help menu.

The last words..


Mode Menu

The Mode Menu includes commands that enable you to choose ThruWin monitoring mode. This menu includes following items:

SumInfo

Memory

Tasks

System File Table

Modules

Global heap

Exit	Just exit this program


Setup Menu

Pop-Up menus are:

Window style...

Font...

Window Style:

This Dialog Box allows you set values which defines ThruWin behaviour:

Test info every(sec.): 	N

Number of seconds. Set the time interval between information scanning.

O Do not Change Position

Radio Button. Usual window.

O Topmost window

Radio Button. Makes ThruWin window topmost - it cannot be hidden or overlayed by other, non-topmost windows..

O Cork Window

Radio button. Defines whether program bring window up on the screen if ThruWin detects information changes.

If cork Window time to show	N

 before hide(sec.):

Number of seconds. Defines how long program window will be shown if it was brought up.

Font...

This dialog box allows you select screen font from available proportional fonts.


Display Menu

This menu item is available only while in Memory mode. It allows you set in different ways memory to screen display scale. Minimum scale is 16 bytes/unit, maximum scale is all available to MS Windows memory to ThruWin window.

Zoom(2x)

Enlarges picture scale twice.

Unzoom(1/2x)

Reduces picture scale twice.

Set scale...

A dialogue box appears, which allows you direct byte/unit scale setting.

Select region

This menu item allows you select memory region you want to see in details. After you select this item, cursor shape changes from arrow to hair cross. Select now first point of  region by pressing mouse button, and then release it at second point of region. Rubber box is being used to show region size while selecting.


Disks Menu

This menu item is available only while in SumInfo mode. It allows you select drives, which free space you want to monitor. Drives can be removable, fixed, network.

List of drives available depends on current computer configuration. By default, removable and network drives are not included to be monitored, while fixed are. To add/remove drive to/from monitoring list simply click it. Checkmark denotes drive free space is monitored.


SumInfo Mode
SumInfo Mode.

This mode shows summary information:

Free spaces on your removable/fixed/network drives.

Free memory.

Resources available.

Total tasks currently running.

Window's caption displays the current time.

You can select disks you need monitor from Disks menu item


Memory Mode

It can show how MS Windows are using your computer memory in details. Display menu item allows to zoom and unzoom; set scale and select region in the window you want to see in details.

Legend:

Coloured strips shows (left to right):

Size of this memory object.

Segment colour shows objects LOCKED attribute. The attribute can be MOVABLE, FIXED, or LOCKED with count. Different colours are for different states. State of memory object is written first in parenthesis.

Strip is red if page is locked in physical memory. Applied to Enhanced mode only. Also is written in parenthesis if page is locked.

This strip also shows state of object its flags. Flags can be: PDB (The process data block for the task is the owner of the memory object), privileged, data, or discardable.

This strip is red when memory object is DATA segment and this segment had process local heap inside it.

This strip shows by colour type of memory object. Object types can be:

UNKNOWN, FREE, DGROUP, DATA, CODE, TASK, RESOURCE, MODULE, INTERNAL, SENTINEL, BURGERMASTER.

If Type is CODE, DATA, or DGROUP, its number for the code is shown in the parenthesis.

And, at last, the last strip, which is shown only if memory object type is RESOURCE- resource data. Resource data can be:

ACCELERATORS, BITMAP, CURSOR, CURSORCOMPONENT, DIALOG, ERRTABLE, FONT, FONTDIR, ICON, ICONCOMPONENT, MENU, NAMETABLE, RCDATA, STRING, USERDEFINED.

Caption displays how many the memory is free now.


The memory type is not known.


The memory object is free.


The object contains the default data segment and the stack segment.


The object contains program data. (It may also contain stack and local heap data.)


The object contains program code.


The object contains the task database.


The object contains the resource type specified.


The object contains the module database.


The object is reserved for internal use by Windows.


The object is either the first or the last object on the global heap


The  object  contains a table that maps selectors to arena handles. It seems to be obsolete. I never met it in Windows 3.0 - 3.1 Global Heap.


The object contains data from the accelerator table


The object contains data describing a bitmap. This includes the bitmap colour table and the bitmap bits.


The object contains data describing a group of cursors. This includes the height, width, colour count, bit count, and ordinal identifier for the cursors.


The object contains data describing a single cursor. This includes bitmap bits and bitmasks for the cursor.


The object contains data describing controls within a dialog box.


The object contains data from the error table.


The object contains data describing a single font. This data is identical to data in a Windows font file (.FNT).


The object contains data describing a group of fonts. This includes the number of fonts in the resource and a table of metrics for each of these fonts.


The object contains data describing a group of icons. This includes the height, width, colour count, bit count, and ordinal identifier  for the icons.


The object contains data describing a single icon. This includes bitmap bits and bitmaps for the icon.


The object contains menu data for normal and pop-up menu items.


The object contains data from the name table.


The object contains data from a user-defined resource.


The object contains data from the string table.


The resource has an unknown resource identifier or is an application-specific named type.


Tasks Mode

This mode allows to monitor tasks currently running, including that not registered

their windows.

Legend:

Column	Meaning

Task	Identifies the task handle for the stack.

(Module)	Specifies the name of the module that contains the

currently executing function.

Prnt	Identifies the parent of the task.

(Module)	Specifies the name of the parent task's module.

Inst	Identifies the instance handle of the task. This value is

equivalent to the task's DGROUP segment selector.

hMod	Identifies the module that contains the currently

executing function.

Events	Specifies the number of pending events.

Caption displays number of tasks currently running.


System File Table Mode

This mode allows to monitor System File Table: All files opened on your disks, their open mode, size and current file pointer positions (This information is retrieved from your DOS, not from MS Windows).(Note: DR DOS 5.0 and DR DOS 6.0 always shows 0 in Position column.)

Legend:

Column	Meaning

Owner	Module opened this file.  If cannot be determined, then hex number is typed. If you see number, then one from two: 1) It is KERNEL opened file. 2) Program, opened this file, is not more running. 3) This is a DOS program running in a window file.

HND	File handles, referred to this file. 19 - means this entry in System file table is used 19 times.

File open mode. Right two letters (from four ones) - local open mode.

Mode	File open mode.

"RW"	READ/WRITE,

"R-"	READ only,

"-W"	WRITE only,

"??"	Impossible combination.

Left two letters (including spaces) - Network access allowed to this file.

Mode	File open mode.

"RW"	READ/WRITE allowed (DENYNONE),

"R-"	READ only allowed (DENYWRITE),

"-W"	WRITE only allowed (DENYREAD),

"--"	deny access at all (DENYALL),

"  "	compatibility mode.

I never meet this  before, but I know, file open mode may include five letters! The first from left can be "I"- file is private to current process and will not be inherited by child processes.

Position	File Pointer position.

Size 	File size.

Caption shows F - Free and B - Busy entries in system file table.


Modules Mode

This mode allows to monitor Modules currently loaded.

Legend:

hMod	Identifies the module handle.

Usage	Specifies the reference count of the module.

FileName	File name for the module.

Caption displays number of modules present.


Global Heap Mode

This mode allows to monitor Global heap. This is the same information, as in

Memory mode, but all only in text. It is very time consuming, and refresh interval for this mode is automatically set to 10 seconds.

Legend:

Column	Meaning

hBlk	(Block Handle) Identifies the global-memory object.

Lock	Specifies the lock count. If this value is zero, the memory object is not locked.

Flgs	(Flags) Specifies additional information about the memory object. This can be the following values:

Value	Meaning

PDB	The process data block (PDB) for the task  is the owner of the memory object.

DATA	Memory object contains Data.

PRIV	Memory object is privileged.

DSCRD	Memory object is discardable. Counts as a free in FreeMem function.

Heap	(HeapPresent) Indicates whether a local heap exists within the global-memory object.

Owner	Identifies the owner of the global-memory object.

Type	Specifies the memory type of the object. Memory type can have one of the following values:

UNKNOWN, FREE, DGROUP, DATA, CODE, TASK, RESOURCE, MODULE, INTERNAL, SENTINEL, BURGERMASTER.

If the Type column is not CODE or RESOURCE, Data column is empty. If Type is CODE, DATA, or DGROUP, Data contains the segment number for the code. If Type is RESOURCE, Data specifies the type of resource.

The type can be one of the following values:

ACCELERATORS, BITMAP, CURSOR, CURSORCOMPONENT, DIALOG, ERRTABLE, FONT, FONTDIR, ICON, ICONCOMPONENT, MENU, NAMETABLE, RCDATA, STRING, USERDEFINED.

Caption displays F - total free memory objects in bytes(objects), B - total busy in (bytes/objects).


Bring up/hide window feature
Program Bring up hide window feature

Maybe you think ThruWin will stay on your screen constantly? No! It will show you information when it changed. And after a few seconds, It will hide its window again, so you can continue your work.

Select Setup then  Window Style....

You will see Dialog Box like this:

Test info every(sec.): 	N

O Do not Change Position

O Topmost window

O Cork Window

If cork Window time to show	N

 before hide(sec.):

[ OK ]	[ Cancel ]	[ Save ]

First control defines how often should Thruwin spy for information changes.

Radio buttons defines ThruWin window behavior - as usual window, topmost (over all other windows), or cork window.

Cork window will be shown over others if information changed.

Last control defines how many seconds should it wait before

hiding its window again.

If cork window: What should you do if you don't be in time for it is showing to you? No problem! Just click its window to let it be active, and, after you complete investigation, select previous application you've worked with.

This cork feature is especially useful if you have disk space constraints. (Show me the guy (girl?) who don't meet disk constrains!) Start application with big disk space consuming demands, and look when ThruWin appears with its window in SumInfo mode. If you see a reason for a trouble, Click its window! And than use File Manager or something else to backup/delete something you don't need now.

Program will never bring up when it appear as an icon (minimized). So, if ThruWin disturbs you, minimize it.

If you need, you can run program as many times you want and set different mode for its every instance. It will remember its screen position, size, mode, etc. for the last instance you will close/exit.


DOS run

I just forgot! If you run me, Capt. Thruwin, without MS Windows, as a usual DOS program, I'll show you  Memory allocation for DOS and System File Table.:


Known bugs

Sometimes, when you select new Mode, some part of the window do not refresh and contains old information. It will change in the next seconds, after new information scan.

Global Heap Mode is the much time-consuming, so scan interval for it always set at last  10 seconds, without showing this in


The last words

I cannot distribute this program as Shareware. I am quit sure, no money will pass thru former SU post. So, am looking for distributors of any kind.

Serge Delov.